home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / modelers / geomview / sgi.lha / Geomview / man / cat1 / togeomview.1 < prev    next >
Text File  |  1993-12-02  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. TOGEOMVIEW(1)       UNIX Programmer's Manual        TOGEOMVIEW(1)
  5.  
  6.  
  7.  
  8. NAME
  9.      togeomview - send commands or OOGL objects to geomview
  10.  
  11. SYNOPSIS
  12.      togeomview [-c] [-g]  [pipename  [program args ...]]
  13.  
  14. DESCRIPTION
  15.      togeomview sends a stream of geomview commands, or OOGL-
  16.      format geometric data, to a cooperating copy of geomview.
  17.      If geomview is not running, it is automatically started.
  18.  
  19.      Typical usage is:
  20.           someprogram | togeomview    or
  21.           someprogram-generating-OOGL-data | togeomview -g
  22.      i.e. a program pipes geometric data into ``stuff''; the data
  23.      is displayed by a copy of geomview run with the -M option
  24.      and a name matching the one given to stuff.
  25.  
  26.      Togeomview uses a named pipe (on the Iris) or a UNIX-domain
  27.      socket (on the NeXT) to communicate with geomview.  In
  28.      either case, the connection is created in the directory
  29.      /tmp/geomview.  The pipe's default name is "Mathematica",
  30.      though this can be overridden.  A geomview object with the
  31.      same name as the
  32.  
  33. FILES
  34.      /tmp/geomview
  35.  
  36. BUGS
  37.      The pipe-based communications scheme imposes several res-
  38.      trictions.
  39.  
  40.      If no copy of geomview is reading from the pipe, or if geom-
  41.      view gets far enough behind, a program writing data to
  42.      ``stuff'' will be forced to block after sending a few kilo-
  43.      bytes.
  44.  
  45.      Because of the buffering in the pipe, the sender may be sub-
  46.      stantially ahead of the geomview display.
  47.  
  48.      If geomview exits, the sending program receives a write-on-
  49.      broken-pipe (SIGPIPE) signal, which will kill it unless
  50.      measures are taken to catch or ignore that signal.
  51.  
  52.      Only one copy of geomview can read from a given pipe at a
  53.      time.  If a second copy attempts to read from it, both will
  54.      probably fail.
  55.  
  56. SEE ALSO
  57.      geomview(1), oogl(5)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.